Zum Inhalt

Getting Startet with adaptor:ex

Lerne in wenigen Schritten, wie du adaptor:ex installierst und ein erstes Level erstellst und startest.

Installation

Installiere die Software NodeJS um adaptor:ex mit dem NodeJS Package Manager NPM zu installieren.

Schaue im Installations Kapitel nach, wenn du adaptor:ex stattdessen mit Docker oder vom Source Code installieren willst.

Sobald Du NodeJS installiert hast, öffne deine Konsole bzw. das Terminal und führe in der Kommandozeile die Installation mit npm aus

Auf macOS und Linux:

sudo npm install -g adaptorex --unsafe-perm

Auf Windows:

npm install -g adaptorex --unsafe-perm

Wenn die Installation erfolgreich war, starte adaptor:ex indem du das folgende Kommando in der Konsole eingibst:

adaptorex

Wenn alles geklappt hat solltest du in etwa das folgende in deiner Kommandozeile sehen:

Die Konsolen Ausgabe einer frischen Installation

Behalte die Konsole geöffnet solange du mit adaptor:ex arbeitest. Sobald du die Konsole schließt wird auch adaptor:ex beendet.

Erste Schritte

Gebe die folgende URL, also die webadresse, deines adaptor:ex setups, im Web Browser ein: http://localhost:8081

Die adaptor:ex Startseite

Wir empfehlen als Browser eine aktuelle Version von Google Chrome oder Firefox zu verwenden.

Die URL kann sich je nachdem mit welchen Einstellungen du adaptor:ex ausführst unterscheiden.

Hast du adaptor:ex auf einem Server oder einem anderen Rechner installiert musst du die URL durch die IP oder den Domainnamen deines Servers ersetzen.

Ein Game erstellen

Beginne damit, ein neues Game Projekt anzulegen. Klicke auf New Game und gib deinem ersten Game einen Namen.

Ein neues Game erstellen

Level hinzufügen

Wenn du das neu erstellte Game Projekt anklickst, landest du in der Übersicht, die alle existierenden level anzeigt. Jedes Game kann aus mehreren Leveln bestehen, die auf verschiedenste Art miteinander verknüpft sind.

Erstelle dein erstes Level mit Add new.

Games und Level bekommen eine eigene Web Adresse, über die sie im Web Browser erreichbar sind. Darum darf der Name keine Leerzeichen oder Sonderzeichen enthalten.

Gib dem Level einen Namen und klicke auf Add new Level.

Ein Level hinzufügen

Level bearbeiten

Öffne das level anschließend, indem du auf den Namen klickst. Jetzt befindest du dich im level Editor.

Start (START) und Endpunkt (QUIT) deines Levels existieren bereits.

Der Level Editor

Suche aus der linken Seitenleiste, den actions, die control action Log Message heraus und ziehe sie per Drag and Drop auf die Mitte der Seite.

Es entsteht ein neues State Element, dass eine Log Message action enthält (log_1).

Eine Action hinzufügen

Klicke auf die neue action, um sie zu bearbeiten. Schreibe einen kurzen Text in das message Eingabefeld und wähle im level Dropdown info aus.

Eine Action bearbeiten

Um dein Level verständlicher zu gestalten, ist es gut allen States nachvollziehbare Namen zu geben.

Auch State Namen dürfen keine Leerzeichen beinhalten, da sie in Variablen zum Einsatz kommen können

Klicke in die Titelzeile deines Log Message State und benenne ihn um.

States umbenennen

Bearbeite auch die Next action next_1 im START State indem du sie anklickst. Wähle dann den neuen State, hier HelloWorld, aus dem next state Dropdown aus um ihn mit dem START State zu verbinden.

2 States verbinden

Level starten

Wechsel vom Bearbeitungs in den Live Modus, indem du auf den Play button in der oberen rechten Ecke klickst

Live Modus Toggle

Die linke Seitenleiste mit den actions schließt sich und ein Menü öffnet sich an der rechten Seitenleiste.

Klicke in der rechten Seitenleiste auf Create Session und dann auf Start Session um eine Session von deinem Level zu erstellen.

Eine Session starten

Die neu gestartete Session ist in der rechten Seitenleiste ausgewählt.

Eine session auswählen

Der HelloWorld State ist bereits hervorgehoben.

Wenn wir eine neue Session von einem Level erstellen, wird automatisch der START State ausgelöst. Die next_1 action hat direkt danach zu unserem State HelloWorld mit der Log Message weitergeführt.

Öffne die Log Konsole, indem du auf den cursor icon klickst.

Log Konsole anzeigen

Die neueste Log Nachricht sollte 'Hello World!' sein.

Indem du auf den Play Icon Play Icon des HelloWorld State klickst, kannst du ihn manuell erneut auslösen. Beobachte die Log Konsole ob die Nachricht erscheint.

Level automatisieren

Wechsel zurück in den Bearbeitungsmodus, indem du erneut auf den Live Toggle Button oben rechts in der Menüleiste klickst.

Suche die Timeout action in der linken Seitenleiste heraus und ziehe sie auf den START State.

Wenn du die action darüber ziehst wird der State hervorgehoben und zeigt an, dass die action diesem State hinzugefügt wird, anstatt einen neuen State zu erstellen.

Wenn wir einem State eine action hinzufügen, die auf etwas wartet, wie ein timer der abläuft, ersetzt sie automatisch eine etwaige Next action.

Bearbeite den timeout. Gib eine kleine Zahl Sekunden im timeout feld an und wähle den HelloWorld State als next state aus.

Einen timeout erstellen

Füge auch dem HelloWorld State eine Timeout action hinzu. Bearbeite den Timeout und wähle diesmal Quit als next state aus.

Wenn du nun in den Live Modus wechselst und eine neue Session startest werden die States in festen Zeitabständen nacheinander ausgelöst.

Mehrere Sessions gleichzeitig

Level Sessions beenden

Sobald der QUIT State erreicht ist, wird die session beendet und verschwindet aus der rechten Seitenleiste.

Deine erste Session wird sich nicht automatisch beenden. Um sie zu beenden kannst du sie in der rechten Seitenleiste schließen (x) oder den QUIT State auslösen wenn du die Session ausgewählt hast.

Jede Session basiert immer auf der aktuellsten Version des Levels. Wenn jedoch der State, in dem sich eine Session befindet, verändert, muss er erneut ausgelöst werden.

Nächste Schritte

Im Glossar findest du mehr über die verschiedenen Grundbausteine, Plugins und Actions von adaptor:ex heraus.

Tutorials leiten dich Schritt für Schritt durch Projekte die du mit adaptor:ex umsetzen kannst.

Lerne zum Beispiel, wie du das Telegram plugin einsetzt, um ein messenger Adventure zu entwickeln: Storytelling mit Telegram und adaptor eX

Oder beginne damit, einen Arduino mit adaptor:ex anzusteuern: Arduino Serial